home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
g_man
/
cat3
/
standard
/
getgdesc.z
/
getgdesc
Wrap
Text File
|
1998-10-20
|
26KB
|
463 lines
ggggeeeettttggggddddeeeesssscccc((((3333GGGG)))) ggggeeeettttggggddddeeeesssscccc((((3333GGGG))))
NNNNAAAAMMMMEEEE
ggggeeeettttggggddddeeeesssscccc - gets graphics system description
CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
lllloooonnnngggg ggggeeeettttggggddddeeeesssscccc((((lllloooonnnngggg iiiinnnnqqqquuuuiiiirrrryyyy))))
PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
_i_n_q_u_i_r_y is a symbolic constant taken from the list below. It
identifies the characteristic about which you want to inquire.
FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
The function returns the value of the requested characteristic, or -1, if
the request is invalid or its value cannot be determined.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
ggggeeeettttggggddddeeeesssscccc allows you to inquire about characteristics of the currently
selected screen. If the inquired characteristic is about bitplane
configuration, ggggeeeettttggggddddeeeesssscccc will return a value that indicates the absolute
maximum resources available for the individual characteristic. It is not
guaranteed that the bitplane configuration will reflect these values, as
ggggccccoooonnnnffffiiiigggg reconciles the various requests for resources. You must call
ggggeeeettttggggccccoooonnnnffffiiiigggg to find out the result of the compromises made by ggggccccoooonnnnffffiiiigggg.... You
can call ggggeeeettttggggddddeeeesssscccc prior to graphics initialization, as its return values
are unaltered by any commands issued after initialization.
The symbolic names of the inquiries and their meanings are specified
below:
SSSSccccrrrreeeeeeeennnn BBBBoooouuuunnnnddddaaaarrrryyyy IIIInnnnqqqquuuuiiiirrrriiiieeeessss
GGGGDDDD____XXXXMMMMMMMMAAAAXXXX
GGGGDDDD____YYYYMMMMMMMMAAAAXXXX
Vertical and horizontal size of the screen in millimeters.
GGGGDDDD____XXXXPPPPMMMMAAAAXXXX
GGGGDDDD____YYYYPPPPMMMMAAAAXXXX
Vertical and horizontal size of the screen in pixels.
GGGGDDDD____ZZZZMMMMAAAAXXXX
GGGGDDDD____ZZZZMMMMIIIINNNN
Maximum and minimum depth values that can be stored in the z-buffer
of the normal framebuffer.
FFFFrrrraaaammmmeeeebbbbuuuuffffffffeeeerrrr DDDDeeeepppptttthhhh IIIInnnnqqqquuuuiiiirrrriiiieeeessss
GGGGDDDD____BBBBIIIITTTTSSSS____AAAACCCCBBBBUUUUFFFF
Maximum number of bitplanes per color component in the hardware
accumulation buffer, if one exists. Otherwise the number of
bitplanes per color component in the software version of the
accumulation buffer, if it is implemented. Otherwise 0.
GGGGDDDD____BBBBIIIITTTTSSSS____AAAACCCCBBBBUUUUFFFF____HHHHWWWW
Maximum number of bitplanes per color component in the hardware
accumulation buffer, if one exists. Otherwise 0.
PPPPaaaaggggeeee 1111
ggggeeeettttggggddddeeeesssscccc((((3333GGGG)))) ggggeeeettttggggddddeeeesssscccc((((3333GGGG))))
GGGGDDDD____BBBBIIIITTTTSSSS____CCCCUUUURRRRSSSSOOOORRRR
Number of bitplanes available in the cursor.
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____DDDDBBBBLLLL____AAAALLLLPPPPHHHHAAAA
Maximum number of bitplanes available in the normal framebuffer to
store alpha in double buffered RGB mode.
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____DDDDBBBBLLLL____CCCCMMMMOOOODDDDEEEE
Maximum number of bitplanes available in the normal framebuffer to
store the color index in double buffered color map mode.
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____DDDDBBBBLLLL____MMMMMMMMAAAAPPPP
Maximum number of bitplanes available in the normal framebuffer to
store the color index in double buffered multimap mode.
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____DDDDBBBBLLLL____RRRREEEEDDDD
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____DDDDBBBBLLLL____GGGGRRRREEEEEEEENNNN
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____DDDDBBBBLLLL____BBBBLLLLUUUUEEEE
Maximum number of bitplanes available in the normal framebuffer to
store red, green, and blue in double buffered RGB mode. If any of
these are 0, then double buffered RGB mode is not available.
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____SSSSNNNNGGGG____AAAALLLLPPPPHHHHAAAA
Maximum number of bitplanes available in the normal framebuffer to
store alpha in single buffered RGB mode.
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____SSSSNNNNGGGG____CCCCMMMMOOOODDDDEEEE
Maximum number of bitplanes available in the normal framebuffer to
store the color index in single buffered color map mode.
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____SSSSNNNNGGGG____MMMMMMMMAAAAPPPP
Maximum number of bitplanes available in the normal framebuffer to
store the color index in single buffered multimap mode.
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____SSSSNNNNGGGG____RRRREEEEDDDD
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____SSSSNNNNGGGG____GGGGRRRREEEEEEEENNNN
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____SSSSNNNNGGGG____BBBBLLLLUUUUEEEE
Maximum number of bitplanes available in the normal framebuffer to
store red, green, and blue in single buffered RGB mode. If any of
these are 0, then single buffered RGB mode is not available.
GGGGDDDD____BBBBIIIITTTTSSSS____NNNNOOOORRRRMMMM____ZZZZBBBBUUUUFFFFFFFFEEEERRRR
Maximum number of useful bitplanes in the z-buffer of the normal
framebuffer, If 0, then there is no z-buffer.
GGGGDDDD____BBBBIIIITTTTSSSS____OOOOVVVVEEEERRRR____SSSSNNNNGGGG____CCCCMMMMOOOODDDDEEEE
Maximum number of bitplanes available in the overlay framebuffer to
store the color index in single buffered color map mode.
GGGGDDDD____BBBBIIIITTTTSSSS____PPPPUUUUPPPP____SSSSNNNNGGGG____CCCCMMMMOOOODDDDEEEE
Maximum number of bitplanes available in the popup framebuffer to
store the color index in single buffered color map mode.
PPPPaaaaggggeeee 2222
ggggeeeettttggggddddeeeesssscccc((((3333GGGG)))) ggggeeeettttggggddddeeeesssscccc((((3333GGGG))))
GGGGDDDD____BBBBIIIITTTTSSSS____SSSSTTTTEEEENNNNCCCCIIIILLLL
Maximum number of bitplanes available in the normal framebuffer for
use as stencil bitplanes. 0 if sssstttteeeennnncccciiiillll is not functional.
GGGGDDDD____BBBBIIIITTTTSSSS____UUUUNNNNDDDDRRRR____SSSSNNNNGGGG____CCCCMMMMOOOODDDDEEEE
Maximum number of bitplanes available in the underlay framebuffer to
store the color index in single buffered color map mode.
MMMMiiiisssscccceeeellllllllaaaannnneeeeoooouuuussss IIIInnnnqqqquuuuiiiirrrriiiieeeessss
GGGGDDDD____AAAAFFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN
1 if aaaaffffuuuunnnnccccttttiiiioooonnnn is functional, 0 if it is not.
GGGGDDDD____AAAAFFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN____MMMMOOOODDDDEEEESSSS
1 if all aaaaffffuuuunnnnccccttttiiiioooonnnn functions are supported, 0 if they are not.
GGGGDDDD____AAAALLLLPPPPHHHHAAAA____OOOOVVVVEEEERRRRUUUUNNNNDDDDEEEERRRR
1 if alpha bitplanes in the normal framebuffer can be allocated as
color map bitplanes in the overlay or underlay framebuffers, 0 if
they cannot.
GGGGDDDD____BBBBLLLLEEEENNNNDDDD
1 if blending is supported in all framebuffers that support RGB
mode, 0 otherwise. (See bbbblllleeeennnnddddffffuuuunnnnccccttttiiiioooonnnn.)
GGGGDDDD____BBBBLLLLEEEENNNNDDDDCCCCOOOOLLLLOOOORRRR
1 if bbbblllleeeennnnddddccccoooolllloooorrrr is supported in all framebuffers that support RGB
mode, 0 otherwise.
GGGGDDDD____CCCCIIIIFFFFRRRRAAAACCCCTTTT
1 if fractional interpolation of color indices is supported in all
framebuffers, 0 otherwise. (See ccccoooolllloooorrrrffff.)
GGGGDDDD____CCCCLLLLIIIIPPPPPPPPLLLLAAAANNNNEEEESSSS
Number of user-defined clipping planes supported. 0 if none are
supported. (See cccclllliiiippppppppllllaaaannnneeee.)
GGGGDDDD____CCCCRRRROOOOSSSSSSSSHHHHAAAAIIIIRRRR____CCCCIIIINNNNDDDDEEEEXXXX
Color index whose color map entry controls the color of the cross-
hair cursor.
GGGGDDDD____MMMMUUUUXXXXPPPPIIIIPPPPEEEESSSS
Number of other graphics pipes available to be video multiplexed
with the graphics pipe associated with the current screen.
GGGGDDDD____DDDDBBBBBBBBOOOOXXXX
1 if the dial and button box routines are functional, 0 if they are
not. Unlike most of the others, this inquiry is independent of the
currently selected screen. (See ddddbbbbtttteeeexxxxtttt and sssseeeettttddddbbbblllliiiigggghhhhttttssss.)
GGGGDDDD____DDDDIIIITTTTHHHHEEEERRRR
1 if dithering is supported. 0 otherwise.
PPPPaaaaggggeeee 3333
ggggeeeettttggggddddeeeesssscccc((((3333GGGG)))) ggggeeeettttggggddddeeeesssscccc((((3333GGGG))))
GGGGDDDD____FFFFOOOOGGGGVVVVEEEERRRRTTTTEEEEXXXX
1 if ffffooooggggvvvveeeerrrrtttteeeexxxx supports the per vertex fog modes, namely FFFFGGGG____VVVVTTTTXXXX____EEEEXXXXPPPP,
FFFFGGGG____VVVVTTTTXXXX____EEEEXXXXPPPP2222, and FFFFGGGG____VVVVTTTTXXXX____LLLLIIIINNNN. 0 if it does not.
GGGGDDDD____FFFFOOOOGGGGPPPPIIIIXXXXEEEELLLL
1 if ffffooooggggvvvveeeerrrrtttteeeexxxx supports the per pixel fog modes, namely FFFFGGGG____PPPPIIIIXXXX____EEEEXXXXPPPP,
FFFFGGGG____PPPPIIIIXXXX____EEEEXXXXPPPP2222, and FFFFGGGG____PPPPIIIIXXXX____LLLLIIIINNNN. 0 if it does not.
GGGGDDDD____IIIISSSS____NNNNAAAATTTTIIIIVVVVEEEE
0 if the IrisGL implementation is layered on OpenGL.
GGGGDDDD____FFFFRRRRAAAAMMMMEEEEGGGGRRRRAAAABBBBBBBBEEEERRRR
1 if rrrreeeeaaaaddddssssoooouuuurrrrcccceeee((((SSSSRRRRCCCC____FFFFRRRRAAAAMMMMEEEEGGGGRRRRAAAABBBBBBBBEEEERRRR)))) is functional, 0 if it is not.
GGGGDDDD____LLLLIIIIGGGGHHHHTTTTIIIINNNNGGGG____AAAATTTTTTTT2222
1 if the AAAATTTTTTTTEEEENNNNUUUUAAAATTTTIIIIOOOONNNN2222 lighting model attribute is functional, 0 if
it is not. (See llllmmmmddddeeeeffff.)
GGGGDDDD____LLLLIIIIGGGGHHHHTTTTIIIINNNNGGGG____SSSSPPPPOOOOTTTTLLLLIIIIGGGGHHHHTTTT
1 if spotlights are functional, 0 if they are not. (See llllmmmmddddeeeeffff.)
GGGGDDDD____LLLLIIIIGGGGHHHHTTTTIIIINNNNGGGG____TTTTWWWWOOOOSSSSIIIIDDDDEEEE
1 if the TTTTWWWWOOOOSSSSIIIIDDDDEEEE lighting model attribute is functional, 0 if it is
not. (See llllmmmmddddeeeeffff.)
GGGGDDDD____LLLLIIIINNNNEEEESSSSMMMMOOOOOOOOTTTTHHHH____CCCCMMMMOOOODDDDEEEE
1 if antialiased lines are supported in the normal framebuffer in
color map mode, 0 otherwise. (See lllliiiinnnneeeessssmmmmooooooootttthhhh.)
GGGGDDDD____LLLLIIIINNNNEEEESSSSMMMMOOOOOOOOTTTTHHHH____RRRRGGGGBBBB
1 if antialiased lines are supported in RGB mode in all framebuffers
that support RGB mode, 0 otherwise. (See lllliiiinnnneeeessssmmmmooooooootttthhhh.)
GGGGDDDD____LLLLOOOOGGGGIIIICCCCOOOOPPPP
1 if logical operations are supported in all framebuffers, 2 if only
in the normal framebuffer, and 0 otherwise. (See llllooooggggiiiiccccoooopppp.)
GGGGDDDD____MMMMUUUULLLLTTTTIIIISSSSAAAAMMMMPPPPLLLLEEEE
1 if the multisample routines are functional, 0 if they are not.
GGGGDDDD____NNNNBBBBLLLLIIIINNNNKKKKSSSS
Maximum number of blinking color map entries on the selected screen.
If the value is non-zero, it will be at least 20. (See bbbblllliiiinnnnkkkk.)
GGGGDDDD____NNNNMMMMMMMMAAAAPPPPSSSS
Number of smaller color maps available to the user in multimap mode.
On some models, the highest-numbered color map is reserved for use
by the system. (See sssseeeettttmmmmaaaapppp.)
GGGGDDDD____NNNNSSSSCCCCRRRRNNNNSSSS
Number of screens available on the system. Unlike most of the
others, this inquiry is independent of the currently selected
PPPPaaaaggggeeee 4444
ggggeeeettttggggddddeeeesssscccc((((3333GGGG)))) ggggeeeettttggggddddeeeesssscccc((((3333GGGG))))
screen.
GGGGDDDD____NNNNUUUURRRRBBBBSSSS____OOOORRRRDDDDEEEERRRR
Maximum order of any NURBS surface, NURBS curve, and NURBS trimming
curve.
GGGGDDDD____NNNNVVVVEEEERRRRTTTTEEEEXXXX____PPPPOOOOLLLLYYYY
Maximum number of vertices in a single polygon. If there is no
limit, then GGGGDDDD____NNNNOOOOLLLLIIIIMMMMIIIITTTT is returned.
GGGGDDDD____OOOOVVVVEEEERRRRUUUUNNNNDDDDEEEERRRR____SSSSHHHHAAAARRRREEEEDDDD
1 if overlay and underlay planes are shared, 0 if both can be used
simultaneously.
GGGGDDDD____PPPPAAAATTTTSSSSIIIIZZZZEEEE____66664444
1 if 64x64 patterns are supported, 0 otherwise. (See ddddeeeeffffppppaaaatttttttteeeerrrrnnnn.)
GGGGDDDD____PPPPNNNNTTTTSSSSMMMMOOOOOOOOTTTTHHHH____CCCCMMMMOOOODDDDEEEE
1 if antialiased points are supported in the normal framebuffer in
color map mode, 0 otherwise. (See ppppnnnnttttssssmmmmooooooootttthhhh.)
GGGGDDDD____PPPPNNNNTTTTSSSSMMMMOOOOOOOOTTTTHHHH____RRRRGGGGBBBB
1 if antialiased points are supported in RGB mode in all
framebuffers that support RGB mode, 0 otherwise. (See ppppnnnnttttssssmmmmooooooootttthhhh.)
GGGGDDDD____PPPPOOOOLLLLYYYYMMMMOOOODDDDEEEE
1 if ppppoooollllyyyymmmmooooddddeeee is functional, 0 if it is not.
GGGGDDDD____PPPPOOOOLLLLYYYYSSSSMMMMOOOOOOOOTTTTHHHH
1 if antialiased polygons are supported in RGB mode in all
framebuffers that support RGB mode, 0 otherwise. (See ppppoooollllyyyyssssmmmmooooooootttthhhh.)
GGGGDDDD____PPPPUUUUPPPP____TTTTOOOO____OOOOVVVVEEEERRRRUUUUNNNNDDDDEEEERRRR
1 if the popup bitplanes can be allocated as color map bitplanes in
the overlay or underlay framebuffers, 0 if they cannot.
GGGGDDDD____RRRREEEEAAAADDDDSSSSOOOOUUUURRRRCCCCEEEE
1 if rrrreeeeaaaaddddssssoooouuuurrrrcccceeee sources SRC_AUTO, SRC_FRONT, and SRC_BACK are
functional, 0 if they are not.
GGGGDDDD____RRRREEEEAAAADDDDSSSSOOOOUUUURRRRCCCCEEEE____ZZZZBBBBUUUUFFFFFFFFEEEERRRR
1 if rrrreeeeaaaaddddssssoooouuuurrrrcccceeee((((SSSSRRRRCCCC____ZZZZBBBBUUUUFFFFFFFFEEEERRRR)))) is functional, 0 if it is not.
GGGGDDDD____SSSSCCCCRRRRBBBBOOOOXXXX
1 if ssssccccrrrrbbbbooooxxxx is functional, 0 if it is not.
GGGGDDDD____SSSSCCCCRRRRNNNNTTTTYYYYPPPPEEEE
Type of the currently selected screen. Returns GGGGDDDD____SSSSCCCCRRRRNNNNTTTTYYYYPPPPEEEE____WWWWMMMM if
there is window management on the screen or GGGGDDDD____SSSSCCCCRRRRNNNNTTTTYYYYPPPPEEEE____NNNNOOOOWWWWMMMM if
there isn't. There can be at most one window open on screens of the
latter type.
PPPPaaaaggggeeee 5555
ggggeeeettttggggddddeeeesssscccc((((3333GGGG)))) ggggeeeettttggggddddeeeesssscccc((((3333GGGG))))
GGGGDDDD____SSSSTTTTEEEERRRREEEEOOOO
1 if sssseeeettttmmmmoooonnnniiiittttoooorrrr((((SSSSTTTTRRRR____RRRREEEECCCCTTTT)))) is functional, 0 if it is not.
GGGGDDDD____SSSSTTTTEEEERRRREEEEOOOO____IIIINNNN____WWWWIIIINNNNDDDDOOOOWWWW
1 if per-window stereo is functional, 0 if it is not. (See
sssstttteeeerrrreeeeoooobbbbuuuuffffffffeeeerrrr.)
GGGGDDDD____SSSSUUUUBBBBPPPPIIIIXXXXEEEELLLL____LLLLIIIINNNNEEEE
GGGGDDDD____SSSSUUUUBBBBPPPPIIIIXXXXEEEELLLL____PPPPNNNNTTTT
GGGGDDDD____SSSSUUUUBBBBPPPPIIIIXXXXEEEELLLL____PPPPOOOOLLLLYYYY
1 if subpixel positioned lines, points, and polygons (respectively)
are supported in all framebuffers, 0 otherwise. (See ssssuuuubbbbppppiiiixxxxeeeellll.)
GGGGDDDD____TTTTEEEEXXXXTTTTPPPPOOOORRRRTTTT
1 if the textport routines are functional, 0 if they are not.
Unlike most of the others, this inquiry is independent of the
currently selected screen. (See tttteeeexxxxttttppppoooorrrrtttt.)
GGGGDDDD____TTTTEEEEXXXXTTTTUUUURRRREEEE
1 if texture mapping routines are functional, 0 if they are not.
(See tttteeeexxxxddddeeeeffff2222dddd.)
GGGGDDDD____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD
1 if 3D texture mapping routines are functional, 0 if they are not.
(See tttteeeexxxxddddeeeeffff3333dddd.)
GGGGDDDD____TTTTEEEEXXXXTTTTUUUURRRREEEE____DDDDEEEETTTTAAAAIIIILLLL
1 if TTTTXXXX____DDDDEEEETTTTAAAAIIIILLLL is functional, 0 if it is not. (See tttteeeexxxxddddeeeeffff.)
GGGGDDDD____TTTTEEEEXXXXTTTTUUUURRRREEEE____LLLLUUUUTTTT
1 if texture lookup tables are functional, 0 if they are not. (See
ttttlllluuuuttttddddeeeeffff.)
GGGGDDDD____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSHHHHAAAARRRRPPPP
1 if TTTTXXXX____SSSSHHHHAAAARRRRPPPPEEEENNNN is functional, 0 if it is not. (See tttteeeexxxxddddeeeeffff.)
GGGGDDDD____TTTTIIIIMMMMEEEERRRRHHHHZZZZ
Frequency of graphics timer events.
GGGGDDDD____TTTTRRRRIIIIMMMMCCCCUUUURRRRVVVVEEEE____OOOORRRRDDDDEEEERRRR
Maximum order of a trimming curve.
GGGGDDDD____WWWWSSSSYYYYSSSS
Type of window system running on the machine. Returns GGGGDDDD____WWWWSSSSYYYYSSSS____4444SSSS if
a windowing system is currently running or GGGGDDDD____WWWWSSSSYYYYSSSS____NNNNOOOONNNNEEEE if there is
no window system currently running. Unlike most of the others, this
inquiry is independent of the currently selected screen.
GGGGDDDD____ZZZZDDDDRRRRAAAAWWWW____GGGGEEEEOOOOMMMM
GGGGDDDD____ZZZZDDDDRRRRAAAAWWWW____PPPPIIIIXXXXEEEELLLLSSSS
1 if routines that render geometry and routines that render pixels
(respectively) will do it into the z-buffer when zzzzddddrrrraaaawwww is TRUE, 0 if
PPPPaaaaggggeeee 6666
ggggeeeettttggggddddeeeesssscccc((((3333GGGG)))) ggggeeeettttggggddddeeeesssscccc((((3333GGGG))))
they do not.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
gversion, scrnselect
NNNNOOOOTTTTEEEESSSS
This routine is available only in immediate mode.
To inquire about the screen on which the current window is displayed, use
the following sequence:
long savescrn;
...
savescrn = scrnselect(getwscrn());
_v_a_l_1 = getgdesc(_i_n_q_u_i_r_y_1);
_v_a_l_2 = getgdesc(_i_n_q_u_i_r_y_2);
...
scrnselect(savescrn);
PPPPaaaaggggeeee 7777